home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / entrypts.doc < prev    next >
Text File  |  1995-03-31  |  4KB  |  85 lines
  1.       *** LONG ANSWERS TO SHORT QUESTIONS ABOUT ENTRY POINTS *** 
  2.                              by Joe Horn 
  3.  
  4. HCLIMER@UTCVM.BITNET [Harold Climer] writes: 
  5.  
  6. > When someone talks about Entry Points is this the same as SYSEVAL 
  7. > commands? 
  8.  
  9. Short answer: Yes.  Better answer: Suppose you want to turn a string 
  10. object into a name object.  There's a System RPL program called $>ID 
  11. which does that.  It resides in ROM, beginning at hex address #5B15h. 
  12. So if you jump into ROM at 5B15, you run the $>ID program.  You can do 
  13. this by typing #5B15h SYSEVAL (make sure there's a string on level 1 
  14. first!).  The SYSEVAL command merely tells the HP48, "jump to this 
  15. address and evaluate whatever you find there," and in this case it 
  16. finds the $>ID program there and runs it. 
  17.  
  18. Of course, SYSEVAL is like driving a car into a multi-car garage; if 
  19. you don't aim at an actual Entry Point, you'll Crash.  Using SYSEVAL 
  20. on addresses that are not actual entry points can cause the system to 
  21. crash.  Likewise, you'll crash if you do it without the right things 
  22. on the stack, which would be like driving into your garage with your 
  23. vacation luggage piled high on the roof of your car.  You get the 
  24. idea. 
  25.  
  26. > Also what is the difference between Supported and Un-Supported Entry 
  27. > Points? 
  28.  
  29. As HP debugs and improves the HP48, each new ROM version obviously has 
  30. a lot of changes in it; some code gets changed, some code gets added, 
  31. some code gets removed.  This causes many entry points to move.  But 
  32. that would make programs no longer run correctly, since they'd be 
  33. jumping into what used to be valid entry points but no longer are, 
  34. usually resulting in a system crash. 
  35.  
  36. Like the time I awoke in the middle of the night in a motel, but in my 
  37. stupor I thought I was at home, turned to walk into the bathroom, and 
  38. *whack* walked right into the wall.  New entry points.  Bummer. 
  39.  
  40. But over 2,000 of the objects in the bottom 224K of ROM are so useful 
  41. that HP has told software developers about them, what they do, what 
  42. they're called, and best of all, has promised to leave them at the 
  43. same addresses so that System RPL programmers won't have to recompile 
  44. their programs every time a new ROM version comes out.  Since HP is 
  45. "supporting" the use of these entry points (and discouraging the use 
  46. of all others since their use can cause the machine to crash in other 
  47. ROM versions), they're called Supported Entry Points.  $>ID is one 
  48. such System RPL command; it is and will be at address 5B15 in every 
  49. HP48, regardless of ROM version. 
  50.  
  51. There's a whole 'nuther discussion raging about the "supported entry 
  52. points" that are in the 70000h block in the S/SX, and have all been 
  53. moved in the G/GX, but they aren't really "Entry Points" per se 
  54. anyhow, just addresses of useful bits of system RAM, so I won't get 
  55. into that here.  If you see references to "unfrozen entry points", 
  56. don't worry; no frozen ROM programs have moved.  (Knock on wood). 
  57.  
  58. > How will the differences between the SX and GX affect programmers 
  59. > ability to adapt their SX programs to the GX. 
  60.  
  61. Not much, as long as they stick to supported entry points. 
  62.  
  63. > Will strictly User RPL programs written for the S/SX run on the GX 
  64. > without adaptation? 
  65.  
  66. Yes, because the entire User RPL vocabulary is Supported. 
  67.  
  68. You have NO IDEA how difficult it was for HP to decide to do this. 
  69. They intended not to support User RPL from the S/SX to the G/GX, with 
  70. the excuse that if somebody really wanted to port User RPL to the 
  71. G/GX, all they'd have to do is transfer it in ASCII mode and it'd 
  72. automatically recompile.  But that was ignoring the huge corpus of 
  73. HP48 software already existing which is a hybrid of System RPL and 
  74. User RPL.  They finally gave in, not long before the G series was 
  75. announced, and decided to freeze the addresses of the S/SX User RPL 
  76. command set.  Thank goodness. 
  77.  
  78. > Is the command set of the GX a Super Set of the SX Command Set? 
  79.  
  80. Yes.  The S/SX command set resides in Library 2 and Library 1792. 
  81. The G/GX has those libraries, plus Library 171, in which reside all of 
  82. the new G/GX commands. 
  83.  
  84. -jkh- 
  85.